Carbon


PaintRoundRect

Header: Quickdraw.h Carbon status: Supported

Paints a rounded rectangle with the graphics pen’s pattern and pattern mode.

void PaintRoundRect (
    const Rect *r, 
    SInt16 ovalWidth, 
    SInt16 ovalHeight
);
Parameter descriptions
r

The rectangle that defines the rounded rectangle’s boundaries.

ovalWidth

The width of the oval defining the rounded corner.

ovalHeight

The height of the oval defining the rounded corner.

DISCUSSION

Using the pattern and pattern mode of the graphics pen for the current graphics port, the PaintRoundRect function draws the interior of the rounded rectangle bounded by the rectangle that you specify in the r parameter. Use the ovalWidth and ovalHeight parameters to specify the diameters of curvature for the corners of the rounded rectangle.

The pen location does not change.

Use FillRoundRect to draw the interior of a rounded rectangle with a pen pattern different from that for the current graphics port.

SPECIAL CONSIDERATIONS

The PaintRoundRect function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)